排除应用程序的性能问题

Kanzi 提供多种测量应用程序性能的方法并显示各种性能参数。使用这些方式和参数提高应用程序的性能。

在 Kanzi Studio 中查看应用程序的性能

要在 Kanzi Studio 中分析您的应用程序的性能和内部结构，请在预览 (Preview) 中点击进入分析 (Analyze) 模式，然后右键点击并选择：

性能 HUD (Performance HUD) 显示了 Kanzi 应用程序在过去 500 帧中的整体性能指标，包括：
- 帧持续期间 (Frame Duration (ms)) 以毫秒为单位显示渲染最后一帧的时间及平均、最高和最低耗时。帧持续期间 (Frame Duration (ms)) 图中的最高值显示最长时间，最低值是最近 500 帧期间渲染一帧所用的平均时间。
  信息可用于识别 Kanzi 应用程序中的性能瓶颈。例如，您可以通过在多个帧上分布渲染来找出如何提高应用程序的性能。请参阅在多个帧上分布渲染。
- 每秒帧数 (Frames Per Second) 显示每秒渲染的帧数。
- 动画持续时间 (Animation Duration (μs)) 以微秒为单位显示执行应用程序中最后一帧的所有动画所需的时间及平均、最高和最低耗时。
- 批处理计数 (Batch Count) 显示执行了多少个单独的绘图调用（glDrawElements 和 glDrawArrays）。
  您可以通过 Kanzi Engine API 访问批处理计数，具体方法为调用 getBatchCount()。
  批处理计数 (Batch Count) 图中的最高值显示最近 500 帧期间的最高批处理数，最低值是最后一帧中的批处理数。
- 三角形计数 (Triangle Count) 显示在一帧中总共绘制了多少个单独的三角形。
  您可以访问 Kanzi Engine API 中的三角形计数，方法是调用 getTriangleCount()。
- 纹理切换 (Texture Switches) 显示新纹理绑定到 GPU 的次数。
  您可以访问 Kanzi Engine API 中的纹理切换计数，方法是调用 getTextureSwitchCount()。
- FBO 切换 (FBO Switches) 显示有多少帧缓冲区对象绑定到 GPU。请参阅渲染最佳实践。
  您可以访问 Kanzi Engine API 中的缓冲区切换计数，方法是调用 getFramebufferSwitchCount()。
- 着色器 (Shader) 显示新的着色器绑定到新应用的批处理的次数，以及为最后一帧发送了多少个着色器 uniform。请参阅减少着色器切换。
  您可以访问 Kanzi Engine API 中的着色器切换计数，方法是调用 getShaderSwitchCount()。
  您可以访问 Kanzi Engine API 中发送的 uniform 消息，方法是调用 getUniformSendCount()。
- 缓冲区切换 (Buffer Switches) 显示有多少顶点、索引和 uniform 缓冲区对象绑定到 GPU。
  您可以访问 Kanzi Engine API 中的缓冲区切换计数，方法是调用 getBufferSwitchCount()。
- 缓冲区/纹理数据更新 (Buffer/texture data updates) 显示新的顶点缓冲区或纹理数据上传到 GPU 的次数。如果访问相同的缓冲区进行读写操作，这些权重操作可能会导致 GPU 执行延迟。理想值是 0。
  例如，当文本字形缓存需要频繁更新时，该值可能增加。在这种情况下，要减少字形缓存更新，应减少文本块 (Text Block) 节点中的字号 (Font Size) 属性值。
  您可以访问 Kanzi Engine API 中的信息，方法是调用 getHeavyweightCallCount()。
- 查看摄像机 (View camera) 显示用于在应用程序中显示场景的摄像机 (Camera) 节点名称。
- 资源内存消耗 (Resource memory consumption) 显示您的 Kanzi 应用程序使用的本地 GPU 内存 (VRAM) 和非本地 GPU 内存 (RAM) 的估计量。
  性能 HUD (Performance HUD) 在 Kanzi Studio 预览 (Preview) 中显示的值与在目标设备上运行 Kanzi 应用程序时显示的值不同，因为 Kanzi Studio 在内存中加载并保持应用程序的所有资源。
- 计时器订阅数 显示 KzuMessageDispatcher 中已注册的计时器处理程序数量。计时器处理程序数量过多会降低您应用程序的性能。
  您可以通过调用 kzuMessageDispatcherGetTimerSubscriptionCount() 函数，获取 Kanzi Engine API 中计时器的订阅数量。
- 重复任务 显示 KzuTaskScheduler 中的重复任务数量。大量重复任务会降低您应用程序的性能。
  您可以通过调用 kzuTaskSchedulerGetRecurringTaskCount() 函数，获取 Kanzi Engine API 中重复任务的数量。
- 动画显示您 Kanzi 应用程序中活动的和所有的动画数量。
  您可以通过以下方式，查看 Kanzi Engine API 中的动画数量：
  - 要获取活动动画的数量，请使用 getActiveTimelinePlaybackCount() 函数。
  - 要获取所有动画的数量，请使用 getTimelinePlaybackCount()。
帧缓冲区对象 (Framebuffer objects) 用渲染到纹理中并引起帧缓冲区对象切换的半透明黄色移动条纹标记节点。
透明度 (Transparency) 用透明的蓝色移动条纹标记透明节点。请参阅配置节点以进行有效渲染。
过度绘制 (Overdraw) visualization indicates areas where Kanzi renders multiple times to the same pixel. Lighter green color indicates higher amount of overdraw. 请参阅使用排序过滤器 (Sorting Filter)防止过度绘制。

查看整体性能

要查看您的 Kanzi 应用程序的整体性能：

在 Kanzi Studio 预览 (Preview)中，点击并使用上下文菜单选择性能 HUD (Performance HUD)。
在 application.cfg 中启用完整性能 HUD (Performance HUD) 的显示：
```
PerformanceInfoLevel = 2
```
请参阅 PerformanceInfoLevel。
在应用程序代码的 onConfigure() 函数中启用性能 HUD (Performance HUD) 显示
```
configuration.performanceInfoLevel = ApplicationProperties::PerformanceInfoLevelFull;）
```
请参阅 PerformanceInfoLevel。

在 application.hpp 中，通过调用 getPerformanceInfoLevel() 和 setPerformanceInfoLevel() 函数启用性能 HUD (Performance HUD) 显示：

ApplicationProperties::PerformanceInfoLevel getPerformanceInfoLevel() const
{
    return m_applicationProperties.performanceInfoLevel;
}
void setPerformanceInfoLevel(ApplicationProperties::PerformanceInfoLevel level)
{
    m_applicationProperties.performanceInfoLevel = level;
}

要将帧速率值写入日志文件，您可以通过调用 application.hpp 中的 getFramesPerSecond() 函数，从 Kanzi Engine 检索当前帧速率值。您可以通过调用 getEngine() 从应用程序检索 Kanzi Engine。
要获取渲染帧所用的时间量，您可以调用 application.hpp 中的 getLastFrameTime() 函数。

请参阅应用程序配置参考。

查看图形性能

在 application.cfg 文件或 onConfigure() 函数的应用程序节点中，您可以设置 Kanzi 以打印至调试控制台：

应用程序启动时的图形相关信息，例如 GL 渲染器、版本和着色语言版本。请参阅 LogOpenGLInformation。
应用程序启动时的图形相关扩展的列表。请参阅 LogOpenGLExtensions。
应用程序启动时的图形相关属性的列表，例如交换行为、显示大小以及您应用程序的大小。请参阅 LogSurfaceInformation。
应用程序的图形 API 调用日志。请参阅 GraphicsLoggingEnabled。

查看对象的过度绘制

过度绘制 (Overdraw) visualization indicates areas where Kanzi renders multiple times to the same pixel. Lighter green color indicates higher amount of overdraw. Kanzi uses the stencil buffer to calculate how many times it draws to the same pixel. If you are using the stencil buffer to render your content, the 过度绘制 (Overdraw) visualization can return unexpected results.

The overdraw visualization does not show:

Overdraw for 3D nodes that you render to a composition, which you then render to a texture. In that case, the 过度绘制 (Overdraw) visualization shows the content from a composition that you render to a texture, as a single quad.
Parts of the nodes that are clipped when you set in their ascendant node the Clip Children property to enabled.
Nodes that are completely translucent or nodes that are not visible, including their descendant nodes.

注

过度绘制 (Overdraw) visualization works only when you use the OpenGL backend. You can set the 预览 (Preview) backend in the 工程 (Project) > 属性 (Properties) in the 预览 OpenGL ES 包装 (Preview OpenGL ES Wrapper) property.

To view overdraw in your application, in the Kanzi Studio 预览 (Preview) click to enter the 分析 (Analyze) mode, right-click , and select 过度绘制 (Overdraw).

查看渲染到纹理中的节点

帧缓冲对象之间的切换可能导致某些平台上性能显著下降。Kanzi 将节点渲染到纹理时的条件可能很复杂。例如，旋转、缩放或不透明度均可能导致渲染到纹理出现。

要查看节点是否渲染到纹理中并导致帧缓冲对象切换，请在预览 (Preview) 中点击进入分析 (Analyze) 模式，右键点击，然后选择帧缓冲区对象 (Framebuffer objects)。
预览 (Preview) 用透明的橙色条纹突出显示渲染到纹理的层。

查看渲染为合成渲染目标的节点

您可以在 Kanzi Studio 中看到应用程序 Kanzi 中有哪些 2D 节点渲染成合成渲染目标。

要在预览 (Preview) 中查看使用了阿尔法混合的 2D 节点，在预览 (Preview) 中点击进入分析 (Analyze) 模式，右键点击，然后选择透明度 (Transparency)。
预览 (Preview) 突出 Kanzi 用半透明蓝色条纹渲染为合成渲染目标的节点。

另请参阅